home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / strain.z / strain
Encoding:
Text File  |  1998-10-20  |  2.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTRRRRAAAAIIIINNNN((((1111MMMM))))                                                          SSSSTTTTRRRRAAAAIIIINNNN((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      strain - extract errors from build log files.
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssttttrrrraaaaiiiinnnn [ ----hhhh |||| ----ssss ] [ ----wwww ] [ ----cccc ccccoooonnnntttteeeexxxxtttt ] <_l_o_g_f_i_l_e>
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_t_r_a_i_n is used to extract error messages from a build log. It displays
  16.      the error and a certain amount of context around it.  _s_t_r_a_i_n can work on
  17.      an arbitrary input, but works best with input that has special markers
  18.      known to _s_t_r_a_i_n.  For large build logs, _s_t_r_a_i_n is an effective tool in
  19.      determining build success or failure.
  20.  
  21.      _s_t_r_a_i_n works by folding the log file into 512 character lines and feeding
  22.      these lines through a nawk(1) script which looks for known error messages
  23.      patterns.  When _s_t_r_a_i_n encounters an error, it simply saves that line
  24.      number and continues scanning.  If _s_t_r_a_i_n hits either a marker or
  25.      accumulates _c_o_n_t_e_x_t lines, it dumps the line in errors and the
  26.      surrounding context.  Markers are lines beginning with:  @@@@<<<<,@@@@>>>>,============,
  27.  
  28. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.      ----cccc    accumulate _c_o_n_t_e_x_t lines before dumping any errors.  Default is 15.
  30.  
  31.      ----hhhh    show highlights only. This option prints out every line that begins
  32.            with :-( (Mk's "subsystem build failure" identifier) or = (the
  33.            "subsystem build begin" identifier printed by Mk and some
  34.            makefiles).
  35.  
  36.      ----ssss    provide a summary list of directories with errors before the _s_t_r_a_i_n
  37.            output.
  38.  
  39.      ----wwww    show warning messages, in addition to error messages.
  40.  
  41. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  42.      The ----hhhh and ----ssss options are mutually exclusive.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      nawk(1), fold(1), makewrapper(1)
  46.  
  47. BBBBUUUUGGGGSSSS
  48.      _s_t_r_a_i_n'_s algorithm for finding bugs is simply a list of patterns to
  49.      search for.  New tools often report errors in a way that _s_t_r_a_i_n doesn't
  50.      understand.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.